----------------------------------
 DoR Tileset Upgrade Instructions
----------------------------------


Many of you who have downloaded the Dance of Remembrance Tileset Upgrade are probably currently using the original DoR Tileset, which was released as "version 0.9".  If this is the case, you will probably want to upgrade to the new tileset rather than start from scratch. For those of you who fit this description, read on to learn how to go about this.


------------------------------------------------------------


"Which versions of DoR are directly upgradeable?"


There are three previous versions of the public tileset that were released before the current DoR Update package. Here 
is how those three versions can be upgraded. Remember, the QST file "DoRv1.9b - Upgrade.qst" -- found in the PureZC 
database -- is the default QST file upgrading.


- DoR Tileset v0.9 -
This is the original DoR Tileset found in the database.
It can be upgraded to version 1.9b.

- DoR Tileset v1.9 Prerelease -
This is part of the "prerelease" package that was released just before Christmas '07. It wasn't uploaded to the PureZC database.
Quest makers who used this version will be able to upgrade to the updated v1.9b found in the database, which has some notable additions and changes.

- DoR Tileset v2.0 Prerelease -
This file, also part of the prerelease in December '07, was only intended for questmakers starting a new quest.  Due to 
a variety of reasons, you cannot upgrade directly to v2.0b if you are using this version of the tileset. However, you 
can always import the tiles and palettes from the tileset into your quest individually.


------------------------------------------------------------


"What do I need to do before upgrading my quest-in-progress to the new tileset?"


The easiest way to upgrade is via the "Export Graphics Pack" feature. However, before you do this, you have to make sure your quest is ready to receive the upgrade. Please read this list of requirements:

1. The combo table must contain all of the original combos in their exact original positions. It doesn't matter whether 
the TILES have moved around, just so long as the purpose and appearance of each COMBO remains roughly the same. 
...However...

2. You must be ready to overwrite any and all tiles/combos that you added since you started using the tileset. You can easily back up tiles before you upgrade (via snapshots), but combos are a different story: any combos you created after beginning your quest may turn out to be replaced by new combos after you upgrade. Some items and other sprites will also be automatically updated to new graphics.

3. Palettes will also be overwritten, so any changes you've made to the originals will be lost unless you back them up 
and re-rip them.  I recommend using snapshots to back up each individual palette, but exporting a .ZPL file is also an 
option.


------------------------------------------------------------


"What's the easiest way to upgrade?"


If you met the requirements listed in the last section, you should be able to upgrade the easy way. Before you start, however, I strongly recommend that you MAKE A BACKUP COPY OF YOUR QST FILE. By this I don't mean an auto-backup to a 
QSB file. Save it as an entirely separate file. Again, do NOT upgrade without backing up your QST file.

That said, you should be ready to try implementing the Graphics Pack. To do so, follow these steps:

Step #1:	Open "DoRv1.9b - Upgrade.qst" in your preferred version of ZQuest
		(version 1.92 or higher).*

Step #2:	From the main editor window, select  File -> Export -> Graphics Pack, 
		and choose a place to save the file.*

	* These first two steps are necessary because Graphics Packs 
          can't be transferred between different versions of ZQuest.

Step #3:	Open your quest project in the same version of ZQuest.

Step #4:	Click on  File -> Import -> Graphics Pack, and select the ZGP file 
		you saved in step #2.


In an ideal situation, this would complete the upgrade. However, most quest designers mess around with more than just 
maps and strings and quest rules, so I strongly encourage you to look over the quest for awhile before deciding that 
the upgrade was a success.  You may need to make some adjustments before the quest is working the way you prefer (you 
definitely will if you had to rip tiles and palettes before upgrading).

If your quest isn't currently a candidate for this method, another thing you CAN do is to move all your combos around so they will be in the right position to be overwritten by the new graphics pack.  The difficulty of this task varies depending on how much you have altered since you began your quest with the DoR tileset (v0.9). Also, be very careful 
when moving around combos, as there are a number of serious (but predictable) combo "Move" bugs you will want to avoid. 
To learn how to avoid them, please read my combo FAQ on ZCU.


------------------------------------------------------------


"What do I do after upgrading with the Graphics Pack?"


One thing you will probably notice immediately about the "DoRv1.9b - Upgrade.qst" file is that a lot of 
the new combos had to be squeezed in-between the existing combos, meaning some of them seem rather out 
of place. For instance, you may find some trees way down in the mountain section.  There are also 
several large new combo sections near the end of the combo list, such as new dungeon wall sets and 
snowy overworld combos.

This is because in v0.9, not enough room was left over between the existing combo sections to insert the 
new combos without moving any of the existing ones.  If you like your combos to be organized really well, 
you may wish to move these around so they fit in with the usual organization of the tileset. If so, make 
sure you are familiar with the various bugs and problems the combo list "Move" function has.  I've 
written a combo-moving tutorial which is available over at ZCU.


------------------------------------------------------------


"What can I do if I couldn't upgrade with a Graphics Pack?"

#1 - Other Types of Import/Export

There are a number of alternatives for people who want to upgrade.  For starters, a Graphics Pack is merely a collection of all the information available under the "Quest -> Graphics" menu option.  Among those items, three of them can be imported individually:  tiles, palettes, and combo tables.  You can also export the combo table, but I don't recommend 
individually importing the combo table itself, since it will be quite jumbled if it isn't imported alongside a tile pack. 
On the other hand, it's possible to use the "Grab" feature to rip individual tiles from a .TIL file, and palettes are 
pretty easy to import on their own, even if you've already made a few changes to the destination file.

#2 - "Tile Farming"

For many, the easiest alternative for updating graphics is to simply go into the tileset, open the tile list, and use F12 to take snapshots of anything and everything that is new or improved.  Then, you can go into your own quest and rip the graphics one at a time, using the Grab option in the tile list. Old tiles that have been updated can be overwritten, while new tiles must be comboed. (You can also rip from an exported .TIL file, but note that .TIL files don't include palette information.)

The downside to this method is that you're only really updating the graphics. Any bugs that have been worked out of the tileset since the last version will not come "pre-fixed" for you, and you'll have to figure out the combo structure on your own.

One upside to this method is that you can pair it with a straight palette import, and after that at least half of the work is done for you. :)

#3 - Importing Into the Tileset

Up to this point, the focus has been on importing the tileset's elements into you quest...but it's quite possible to do 
it the other way around.  To do so, you would export all the maps, DMaps, and strings FROM your quest, then import those 
files INTO the tileset file. Since you'd mainly want to do this when none of the other upgrade methods work, you'll 
probably want to use "DoRv2.0b - New Quest.qst" as the recipient file (you might as well, since the "Upgrade" file won't 
help you much here).

The downside to this method is that the combo table of your quest will probably be vastly different from the tileset, meaning all the maps and other elements will be completely jumbled with the wrong combos.  However, this can be remedied if you dedicate enough time to the task, using the "Replace" feature on each individual screen and reassigning combos slots such as the ones in "Secret Combos." This may seem like a daunting task (and it sometimes is), but I HAVE created 
an entire quest starting with this method (namely "Master Quest - New BS Edition"), so I can quite firmly say that it is 
possible. :) (Just be sure to back up your project [i]often[/i]. Consider having multiple backups, too.)



That's all for this tileset FAQ. If you have any questions, please ask me in a public forum post so others can read it!